Page Templates Reference

Page templates are files that form the skeleton structure of generated output files. Often users will create overrides for these files so that they can precisely control the look and function of generated output files. The most common type of page templates to customize are the Page.asp and Splash.asp files, which are used in most all of the output format types.

Namespace and Attributes

ePublisher defines the namespace: wwpage for page templates as follows:

xmlns:wwpage="urn:WebWorks-Page-Template-Schema"

The following shows the page template attributes that can be used along with their purpose.

Attribute

Purpose

wwpage:condition

Controls when elements should be preserved in the generated output.

wwpage:content

Use this attribute to replace the innerHTML or innerXML of an element.

wwpage:replace

Use this attribute to replace the innerHTML/innerXML as well as the outerHTML/outerXML.

wwpage:attribute-<name>

Use this attribute to emit a generated attribute value with name: name. In addition, you can specify a value of either: relative-to-output or copy-relative-to-output or wwsetting:<target-setting-name>. Specifying the value using relative-to-output is useful for file type attributes that require a pathname relative to the parent file. If the copy version is used, it additionally copies the file into the correct location within the generated output directory.

wwpage:NoBreak

Use this attribute to collapse all white space between two elements into nothing.

wwpage:Import

Use this attribute to indicate an that an import operation will take place using one of the *-from-* wwpage attributes.

wwpage:content-from-file

Use this attribute to import the contents of the specified file as the innerHTML of an element.

wwpage:replace-from-file

Use this attribute to import the contents of the specified file as the innerHTML as well as the outerHTML of an element.

wwpage:content-from-lookup

Use this attribute to import the contents of the specified item name generated by ePublisher as the innerHTML of an element.

wwpage:replace-from-lookup

Use this attribute to import the contents of the specified item name generated by ePublisher as the innerHTML as well as the outerHTML of an element.

Note: If you are using wwpage:attribute-<name> to express attribute that uses a namespace of its own, you can use a "-" character in place of the ":" character. For example: wwpage:attribute-xml-lang is used to generate the xml:lang attribute in the output.

The following shows a typical usage of wwpage attributes within a Page.asp or Splash.asp page template.

Attribute

Example usage in Page.asp page template

wwpage:condition

<hr wwpage:condition="header-exists" align="left" />

wwpage:content

<title wwpage:content="title">Title</title>

wwpage:replace

<div wwpage:replace="content">Page content.</div>

wwpage:attribute-<name>

<link rel="StyleSheet" href="css/print.css" wwpage:attribute-href="copy-relative-to-output" type="text/css" media="print" />

wwpage:NoBreak

<a href="#">
<wwpage:NoBreak />
<img src="myimage.png">
</a>

wwpage:Import

<wwpage:Import wwpage:replace-from-file="scripts/common.js" />

wwpage:content-from-file

<div wwpage:Import wwpage:content-from-file="scripts/common.js"></div>

wwpage:replace-from-file

<wwpage:Import wwpage:replace-from-file="css/webworks.css" />

wwpage:content-from-lookup

<div wwpage:Import wwpage:content-from-lookup="catalog-css"></div>

wwpage:replace-from-lookup

<wwpage:Import wwpage:replace-from-lookup="catalog-css" />

Logical AND/OR/NOT in condition attributes

The wwpage:condition attribute supports both logical AND as well as OR to provide for multiple conditions in a single attribute expression. For a logical AND, use white space as a separator between conditions. For a logical OR, use a single comma as a separator between conditions. The following shows a few simple examples of using multiple conditions:

Logic Type

Example

AND (use space)

<hr wwpage:condition="header-exists company-email-exists" />

OR (use ",")

<hr wwpage:condition="header-exists,footer-exists" />

NOT (use "!")

<hr wwpage:condition="!header-exists" />

AND with OR and NOT

<hr wwpage:condition="header-exists company-email-exists,footer-exists !company-email-exists" />

Working with URL and File Paths in Page Templates

The wwpage:attribute-<name> attribute can be used to specify several behaviors when working with URL and File paths. The following shows the list of available modifiers for this wwpage:attribute.

Attribute Modifier

Example

relative-to-output

<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="relative-to-output"></script>

copy-relative-to-output

<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="copy-relative-to-output"></script>

relative-to-output-root

<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="relative-to-output-root"></script>

copy-relative-to-output-root

<script type="text/javascript" src="scripts/common.js" wwpage:attribute-src="copy-relative-to-output-root"></script>

absolute-to-output

<external-graphic content-height="scale-to-fit" width="1in" height="1in" src="url('{wwformat:Pages/images/Logo.png}')" wwpage:attribute-src="absolute-to-output" />

resolved-uri

<external-graphic src="url({wwformat:Pages/images/rms_doc_logo.png})" wwpage:attribute-src="resolved-uri" content-width="100px" content-height="100px" left="0pt" top="0pt" />

resolved-path

<external-graphic src="{wwformat:Pages/images/rms_doc_logo.png}" wwpage:attribute-src="resolved-path" content-width="100px" content-height="100px" left="0pt" top="0pt" />

Using Replacement Types ({}) in Page Templates

In page templates, you can use the {} characters to indicate a parameter to use in an attribute replacement. The {} characters are used to embed a path or parameter within an attribute value. For example, the following is a typical replacement for an HTML img tag, demonstrating how {} characters can be used to improve the result of the replacement.

<img src="url('{images/logo.png}')" wwpage:attribute-src="copy-relative-to-output" />.
Last modified date: 08/12/2026